MovieClip.onData

Доступность

Flash Player 6.

Синтаксис

my_mc.onData = function() {
  // какой-либо код
}

Параметры

Нет.

Возвращает

Ничего.

Описание

Обработчик события; вызывается, когда мувиклип получает данные после вызова MovieClip.loadVariables() или MovieClip.loadMovie(). Вы должны определить функцию, исполняемую при вызове обработчика. Вы можете задать эту функцию на Таймлайне, в методе класса, расширяющего класс MovieClip или связанного с символом в Библиотеке. Для более подробной информации смотри "Присваивание класса символу" в Использовании ActionScript во Flash.

Этот обработчик может использоваться только с мувиклипами, символ которых в Библиотеке связан с классом. Если же Вы хотите, чтобы обработчик вызывался при получении данных определенным мувиклипом, необходимо использовать onClipEvent() вместо данного обработчика. В противном же случае обработчик будет вызван, когда любой мувиклип получает данные.

Пример

В примере ниже демонстрирует корректное использование MovieClip.onData() и onClipEvent(data):

// symbol_mc есть мувиклип в Библиотеке.
// Он связан с классом MovieClip.
// Следующая функция вызывается для каждого экземпляра symbol_mc,
//   когда тот получает данные.
symbol_mc.onData = function() {
   trace("Мувиклип получил данные!");
}
// dynamic_mc есть мувиклип, загруженный с помощью MovieClip.loadMovie().
//   Этот код пытается вызвать функцию при загрузке клипа, 
//   но это не сработает, потому что загруженный ролик не является
//   символом в Библиотеке, с которым связан класс.
function output() {
    trace("Никогда не будет выведено.");
}
dynamic_mc.onData = output;
dynamic_mc.loadMovie("replacement.swf");
// Следующая функция вызывается для каждого мувиклипа,
// получающего данные, вне зависимости, связан с ним символ в Бибилиотеке или нет.
// Таким образом, эта функция вызывается при инициализации symbol_mc и 
//    при загрузке replacement.swf.
OnClipEvent( data ) {
   trace("Мувиклип получил данные!");
}

См. также

onClipEvent()